home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / utility2 / wrn093.zip / WRN.HLP < prev    next >
Text File  |  1992-10-27  |  14KB  |  303 lines
  1. WRN v0.93 beta
  2. ==============
  3.  
  4. What is WRN?
  5. ============
  6. WRN is a Windows-based Usenet news and mail user interface for the
  7. DOS-based Waffle v1.65 UUCP news & mail system. WRN provides
  8. easy-to-use, icon-based access to mail and/or news which Waffle has
  9. downloaded from a Unix host. The user may then reply to or send mail, or
  10. post news items. These are stored by WRN, ready for Waffle to upload to
  11. the host site when it next connects.
  12.  
  13. WRN is designed for a single user who has been using Waffle simply as an
  14. offline Unix mail/news system. To this end:
  15.  
  16.         *       There is no login/password mechanism
  17.  
  18.         *       Once a newsgroup has been read, it is deleted
  19.  
  20.  
  21. Registration
  22. ============
  23. This is a beta-test version of WRN. You may use it for up to one month,
  24. after which you should register it. Registered users will be able to
  25. upgrade their registration to new versions when they are released. This
  26. is distributed as share-ware; you may make as many copies as you wish,
  27. and distribute them wherever you wish, so long as the entire contents of
  28. this archive are kept together, and not modified.
  29.  
  30. As an incentive to registration, this program displays a reminder screen
  31. when it is started, and always appends an "Unregistered user" signature
  32. to messages you send. Both of these are disabled when you register.
  33.  
  34. Registration costs US$10. This may be sent to me as a cheque, money
  35. order, cash or whatever, in any currency you like, so long as I can
  36. convert it to about the equivalent of US$10 here in NZ. Funds should be
  37. sent to:
  38.  
  39.         Tech-Soft Systems
  40.         101 Epuni St
  41.         Lower Hutt
  42.         Wellington
  43.         New Zealand.
  44.  
  45.  
  46. In return, I'll send you a UserCode to plug into WRN to make the
  47. incentives go away. You'll also be encouraging me to produce more
  48. shareware (let's keep the price of software down). You'll also get a
  49. nice warm righteous feeling in the pit of your tummy...
  50.  
  51.  
  52. Setting up WRN
  53. ==============
  54. WRN is written in Visual Basic, so VBRUN100.DLL must be accessible in
  55. your PATH. VBRUN100.DLL is freely available from many sites; it is not
  56. included in this archive to reduce network load and file transmission
  57. times.
  58.  
  59. As mentioned earlier, WRN is a user interface for Waffle 1.65. You must
  60. first install Waffle and get it running correctly, downloading files and
  61. uploading replies. I won't describe that process here, partly because it
  62. is long and involved, partly because it's described in the Waffle
  63. documentation, and partly because it's not really my problem. Once
  64. Waffle is working correctly, you can probably discard large parts of it.
  65.  
  66. You're now ready to get WRN itself set up and runnign.
  67.  
  68. You need to create a file called WRN.INI in the directory from which you
  69. will be running WRN. I suggest that you keep all the WRN files in the
  70. same directory. WRN.INI will contain 17 lines of plain ASCII text
  71. (terminated by CRLF), with one entry per line. It is a standard Windows
  72. .INI file. I've included my WRN.INI file in this release as an example
  73.  
  74. The following entries are required:
  75. [WRN]           The group identifier
  76.  
  77. UseNetFile      Location of your Waffle newsgroups file. This is
  78.                 normally called USENET and located in your WAFFLE\SYSTEM
  79.                 directory. It contains a list of all the newsgroups that
  80.                 Waffle expects/knows about, and the directories where it
  81.                 places articles belonging to these newsgroups.
  82.                 e.g. UseNetFile=C:\WAFFLE\SYSTEM\USENET
  83.  
  84. NewsDir         Name of your Waffle news directory. This is the "root"
  85.                 of the directory structure in which Waffle will place
  86.                 your news articles.
  87.                 e.g. NewsDir=C:\WAFFLE\NEWS\
  88.  
  89. QuotePrefix     This string is added to the beginning of each line when
  90.                 you reply to a mail or news message.
  91.                 e.g. QuotePrefix="> "
  92.  
  93. StaticFile      The name and location of your Waffle STATIC file. This
  94.                 will be in the same directory as your USENET file. It
  95.                 contains information that Waffle needs for
  96.                 communications, etc. Some of that is useful to WRN too.
  97.                 e.g. StaticFile=c:\waffle\system\static
  98.  
  99. UserID          Your username on your Waffle system. This is used by
  100.                 Waffle (& WRN) to locate your mail, and included as part
  101.                 of your Email address.
  102.                 e.g. UserID=frank
  103.  
  104. UserCode        This number will be sent to you when you register WRN.
  105.                 It is calculated from your full name. After registering,
  106.                 you'll be able to add your own signature to your
  107.                 messages, and the introductory reminder screen won't
  108.                 appear.
  109.                 e.g. UserCode=12345
  110.  
  111. TimeZone        Your time-zone: appended to the date and time of your
  112.                 messages.
  113.                 e.g. TimeZone=NZT
  114.  
  115. SiteID          Your site's "Internet name". Typically this will be a
  116.                 name, you've chosen tacked onto the front of the name of
  117.                 the site you get your newsfeed from.
  118.                 e.g. SiteID=whare.cavebbs.welly.gen.nz
  119.  
  120. UserName        Your full name; put whatever you like here, but if you
  121.                 change it, you're going to have to re-register.
  122.                 e.g. UserName=Frank van der Hulst
  123.  
  124. Organisation    Your organisation's name: included in outgoing message
  125.                 headers. Put whatever you like here.
  126.                 e.g. Organisation=Tech-Soft Systems, Wellington, NZ
  127.  
  128. MailOutDir      Directory where outgoing mail is stored until it can be
  129.                 uploaded to your host site. Waffle on my system uses my
  130.                 host's siteID as part of the path. The spool variable in
  131.                 my WAFFLE/SYSTEM/STATIC points to C:\SPOOL.
  132.                 e.g. MailOutDir=c:\spool\cavebbs
  133.  
  134. SeqFile         The name of Waffle's outgoing sequence file. Waffle
  135.                 keeps track of outgoing messages by storing the number
  136.                 of the last message sent (or is it the next message to
  137.                 send) in a file in its UUCP directory. My
  138.                 WAFFLE/SYSTEM/STATIC file's dialers variable points to
  139.                 the same directory.
  140.                 e.g. SeqFile=c:\waffle\uucp\sequence
  141.  
  142. NewsReply       Directory to store your outgoing news postings until
  143.                 they can be uploaded to your host site. These files are
  144.                 stored in a different format from outgoing mail, and in
  145.                 a different directory. You will need to delete messages
  146.                 from here periodically, otherwise your disk will
  147.                 gradually fill up with out-of-date replies. I've created
  148.                 a directory off the WAFFLE\NEWS directory, but you can
  149.                 put them wherever you want.
  150.                 e.g. NewsReply=c:\waffle\news\reply
  151.  
  152.  
  153. NewsOutList     File to store a list of replies until they are batched
  154.                 and sent to your host. This name is created by appending
  155.                 your host's name to SPOOL\COMPRESS
  156.                 e.g. NewsOutList=c:\spool\compress\cavebbs
  157.  
  158. SigFile         Location of your signature file. After registering WRN,
  159.                 you will be able to add a signature to the end of
  160.                 outgoing messages. The signature file may be as long as
  161.                 you like, containing ASCII text. You may find it
  162.                 convenient to use the same signature file as Waffle
  163.                 uses.
  164.                 e.g. SigFile=c:\user\frank\mailsig
  165.  
  166. UUDecode        The name of your UUDecode executable program. This
  167.                 allows you to specify what program WRN should execute
  168.                 when you select its UUDecode function. WRN will execute
  169.                 this program, with the full path of the currently
  170.                 selected message as a command-line parameter. There is
  171.                 no support for multi-part messages.
  172.  
  173.                 I recommend Extract 3.00, which is a shareware program
  174.                 written by Darren E. Penner. EXTRACT is free to
  175.                 individuals who should register with Darren.
  176.                 Corporate/Educational cost is $10. Darren can be
  177.                 contacted by Email at dpenner@ee.ualberta.ca or by snail
  178.                 mail to
  179.  
  180.                  Darren E. Penner
  181.                  #904-17327 69th Avenue
  182.                  Edmonton, Alberta, Canada T5T 3S8
  183.  
  184.                 e.g. UUDecode=c:\windows\util\extract.exe
  185.  
  186. Starting WRN
  187. ============
  188. Change to the directory where WRN.INI and WRN.HLP are located (I suggest
  189. putting these files in the same directory as WRN.EXE), then run WRN.EXE.
  190. You could do this
  191.  
  192.         *       from PROGMAN's Run command,
  193.         *       by creating an icon in a PROGMAN group
  194.         *       by using a PIF file
  195.         *       from an icon bar such as CLYSMIC
  196.  
  197.  
  198. Using WRN
  199. =========
  200. Across the top of the WRN form is a "tool-bar"; a set of icons to
  201. perform various functions. They are (from left to right):
  202.  
  203.         *       Catchup        -- Delete all messages in current newsgroup
  204.         *       New         -- Write a new message for mail/posting
  205.         *       Load        -- Load a text file for mail/posting
  206.         *       Save        -- Save a message to disk
  207.         *       Cancel      -- Cancel a reply/new message
  208.         *       Rot-13      -- Decrypt encrypted messages
  209.         *       Mail        -- Send a message as mail
  210.         *       News        -- Post a message to a newsgroup
  211.     *    UUDecode    -- Decode a UUEncoded file from a message
  212.         *       About       -- Informaation about WRN
  213.         *       Help        -- Read WRN.HLP (this file)
  214.  
  215. Below the tool-bar are two list boxes; the left-hand one (yellow
  216. background) shows newsgroups (including MAIL if you have some mail
  217. waiting) which contain messages. A newsgroup may be selected by clicking
  218. (why does Windows need double-clicks every-where?) once on the group you
  219. want to read. The right-hand list box (green background) contains a list
  220. of message subjects (and authors) in the currently selected newsgroup.
  221. Click on the message you want to read, it appears in the large
  222. message-box (white background) at the bottom of the screen.
  223.  
  224. To reply via Mail, click on the message-box (quote marks should appear
  225. at the beginning of each line) & edit it. Use the Mail icon to send
  226. mail; you will be prompted for a Subject, and who to send it to. You
  227. also get the chance to add a signature (contained in a file specified in
  228. WRN.INI) to the end of your message. If you have second thoughts, use
  229. the Cancel icon.
  230.  
  231. Similarly, to follow-up to a newsgroup, click on the message-box, edit
  232. it, and use the News icon to post it; you will be prompted for a
  233. Subject, Newsgroups to post to, and whether to append your signature
  234. file.
  235.  
  236. To send new mail or post new news to a newsgroup, click on the New
  237. icon, then type your message in the message window, followed by clicking
  238. on either the Mail or the News icon.
  239.  
  240. To mail or post an ASCII file, click on the Load icon... You will be
  241. prompted for the source drive/path/filename. When you've selected the
  242. file, it will be loaded into the message-box, and can then be sent by
  243. clicking on the Mail or News icon.
  244.  
  245. The Save icon is used to save the displayed message to a file...a dialog
  246. box allows you to select the destination drive/path/filename. If the
  247. file already exists, the message is appended to the existing file. Note
  248. that this saves the entire file, including the header.
  249.  
  250. To decrypt a message which has been Rot-13'ed, use the Rot-13 icon.
  251. Similarly, to encrypt a message in Rot-13 format, use the Rot-13 icon.
  252.  
  253. To extract a file which has been UUEncoded, select the UUDecode icon.
  254. This will run the external UUDecode program specified in your WRN.INI
  255. file.
  256.  
  257. The Catch-up icon DELETES ALL MESSAGES in the selected newsgroup/mail.
  258. WRN was designed for a system like mine... one user downloading
  259. newsgroups and/or mail overnight. So once you've read the group there's
  260. no need to keep it clogging your disk.
  261.  
  262. The Help icon will bring up a form which displays the WRN.HLP file
  263. (that is, this file). You may like to customise this file... feel free
  264. to.
  265.  
  266.  
  267. PLANNED IMPROVEMENTS
  268. ====================
  269. *       Proper context-sensitive help
  270.  
  271. *       Fix a problem which (because of strange internals in VB) limits
  272.         messages 16K. Currently, if one is displayed which is more than
  273.         16K, WRN will beep at you and add a "*** Truncated ***" line to
  274.         the beginning of the displayed text. If you select Save, it will
  275.         still save the *entire* file.
  276.  
  277. *       Allow cutting and pasting via the clipboard.
  278.  
  279. *       One alpha-tester asked for Catch-up to work like Waffle... (i.e.
  280.         don't delete old messages) so that it can be used in a
  281.         multi-user system. If more people ask, that may be added
  282.         (although I like it like this :-)
  283.  
  284. *       Combo-box for newsgroups.
  285.  
  286. *       Any other suggestions??
  287.  
  288.  
  289. FEEDBACK
  290. ========
  291. Please send any comments (both positive and negative) or suggestions to
  292. me so that I can improve this product. That still applies even if you
  293. don't register.
  294.  
  295. I can be reached via Internet Email at:
  296.  
  297.         f_vander@comp.vuw.ac.nz
  298.         frank@cit.ac.nz
  299.         frank@whare.cavebbs.welly.gen.nz
  300.  
  301. If you don't have Internet access, you could even resort to Snail-mail.
  302.  
  303.